home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 0285.ZIP / DB3SGEN.DOC < prev    next >
Text File  |  1985-10-08  |  7KB  |  186 lines
  1.                             db3ScrnGen version 1.0                     Page 1
  2.  
  3.                         Copyright 1985 David W. Terry
  4.  
  5.  
  6.  
  7. Preliminary Documentation.
  8.  
  9.  
  10. db3ScrnGen is a dBase III(tm) Screen Editor and Program Generator designed as
  11. an editing environment where Screens can be easily designed and then with the
  12. push of a button a dBase III program which reproduces and utilizes your screen
  13. is produced.
  14.  
  15. This is the first release of the program and as such I am open to suggestions
  16. or comments as to its functions or for new functions to be incorporated into
  17. it.  This program is basically what you make it.  The more people that use it
  18. the more I will develop it to include more functions.
  19.  
  20. The program is being distributed under the TRYWARE concept, that is:  You may
  21. TRY the program at your own pace, without pressure, copy protection hassles,
  22. or paying for something you can't use. You decide for yourself if it suits your
  23. needs.
  24.  
  25. What's the price?  Nothing if you DON'T use it.  If you do USE it or find it of
  26. benefit to you, a small charge of $20.00 is required.  This gives you the
  27. right to use the program, make as many backups as necessary, receive
  28. notification of any updates to the program, and receive one free update on
  29. disk (others updates will be distributed either through Public Domain, or
  30. on Disk from me at a $5.00 nominal charge for the disk, shipping and handling).
  31.  
  32. WARRANTY:
  33. Unlike most software that today merely warrants the diskette it is supplied on,
  34. this program is warranted that it functions as is claimed in the documentation
  35. or in it's accompanying help screens, so long as the program, documentation or
  36. help information is not tampered with or altered in any way.
  37. If for any reason the program fails to perform as is claimed and you have paid
  38. your $20.00 fee, the program will either be fixed and sent free of charge, or
  39. you will receive your money back (minus $5.00 if you have received a copy on
  40. disk and not returned it).
  41.  
  42.  
  43. Send all money, inquires, orders, suggestions, etc. to:
  44.  
  45.                                  David W. Terry
  46.                               3036 So. Putnam Ct.
  47.                           West Valley City, Ut 84120
  48.  
  49.  
  50.  
  51.  
  52. ---- Please Read ----
  53.  
  54. One note must be made - That is that I designed the program to include graphics
  55. characters in it's editing capabilities - as you can see by pressing the
  56. help key [F1] and then pressing [PgDn].  However, if you do not have SuperKey
  57. you will quickly notice that none of the [Alt] key combinations involving a key
  58. from the 10-Key pad will work, however, if you are familiar with the ASCII
  59. codes for graphics characters, you may still enter them by doing the
  60. following...  To generate a double horizontal line press  [Alt] and using the
  61. 10-key pad type the number 205, then let go of the  [Alt] key.
  62.  
  63. I am working on a fix to this problem.  It has to do with the way BIOS
  64. interprets keystrokes and involves bypassing the BIOS in a manner similar to
  65. what SuperKey does.
  66.  
  67.                             db3ScrnGen version 1.0                     Page 2
  68.  
  69.  
  70. DESIGNING YOUR SCREENS:
  71. -----------------------
  72.  
  73. When the program first comes up (after the initial screen), you are greeting
  74. with a blank slate with a line down on the bottom for messages and other
  75. information.
  76.  
  77. To create your screen, simply type on the screen as you would like the basic
  78. screen to appear, putting in the names of Input or Output fields, dbase III
  79. functions, etc.
  80.  
  81. For Example:
  82.  
  83.  
  84. [Time()]                   dBase III Input Screen                   [Date()]
  85. ============================================================================
  86.  
  87. Please Enter the following:
  88.  
  89.    Name: [Name]
  90.  
  91. Address: [Address]
  92.  
  93.    City: [City]               State:  [State]     Zip:  [ZipCode]
  94.  
  95.  
  96.  
  97. In the above example, the the brackets [] are including only to show which
  98. areas will then be given a meaning as explained below.
  99.  
  100. The names TIME(), DATE(), NAME, ADDRESS, CITY, STATE and ZIPCODE are all
  101. either Input, Output, or Input/Output fields.  These can be marked by pressing
  102. positioning the cursor at the beginning of one of the fields and pressing
  103. [Alt-B] then moving to the end of the field and pressing [Alt-B] once again to
  104. mark the area, then press either [F3] or [F4] to designate the field as an
  105. input or output field.
  106.  
  107. For Example:
  108.  
  109.   To designate TIME() as an output field, move the cursor to the letter "T"
  110. press [Alt-B], move the cursor to the ")" and press [Alt-B].  The field is
  111. now highlighted (this is the same for block copy, block move, and block fill).
  112. Now press the [F3] key to designate the marked block as an Output Field.
  113.  
  114.   To designate NAME as an Input/Output field, do the same as the above
  115. to highlight the block, then press [F4] to designate the field for Input or
  116. Output (dBase naturally prints the current contents of NAME before allowing
  117. performing the GET in an @ say...get statement).
  118.  
  119.                             db3ScrnGen version 1.0                     Page 3
  120.  
  121.  
  122.  
  123. GETTING HELP WHEN YOU NEED IT:
  124. ------------------------------
  125.  
  126. Pressing the [F1] Help key at any time will give you help as to what keys
  127. have what meanings when using the program. If there is insufficient information
  128. on the Help screen, you may get more detailed information by pressing the key
  129. in question.
  130.  
  131. For Example:   To find out what the key combination [Alt-B] does, simply
  132.                press [F1] to view the main help screen then hold down
  133.                the [Alt] key while typing the letter [B].
  134.  
  135.  
  136.  
  137. GENERATING THE DBASE PROGRAM:
  138. -----------------------------
  139.  
  140. To generate the program which will print the screen you have designed,
  141. outputting the output fields and reading in the input fields, simply press
  142. the [F7] key.  Then enter the name of the program to generate (for example:
  143. MYPROG.PRG).  That's all there is to it.
  144.  
  145.  
  146.  
  147. SAVING YOUR SCREENS:
  148. --------------------
  149.  
  150. Pressing [F10] will save the screen as you have designed it, making changes
  151. to your program a simple matter of loading in the screen, modifying it, and
  152. then re-generating the program.
  153.  
  154.  
  155. LOADING YOUR SCREENS:
  156. ---------------------
  157.  
  158. Loading your previously saved Screens requires you to press the [F8] key, and
  159. then enter the name you used to save the screen.  (Example:  MYSCREEN.SCN).
  160.  
  161.  
  162.  
  163. VIEWING A DIRECTORY:
  164. --------------------
  165.  
  166. To view a directory, whether it be the default, another directory, or a
  167. directory on another disk, simply press [Alt-D] and then enter the path
  168. information including wildcards etc, the same as you would at the DOS prompt.
  169. (Example:  C:\DBASE\*.PRG).
  170.  
  171.                             db3ScrnGen version 1.0                     Page 4
  172.  
  173.  
  174.  
  175. This program was originally developed as an aid for myself and my colleagues
  176. in quickly producing nice looking screens for dBase III programs.  We are
  177. heavy users of dBase III and realizing that the time spent encoding a program
  178. is often the most expensive part of the development costs, this program
  179. was therefore intended to be quick, easy to use, and yet powerful.
  180.  
  181. I encourage anyone who is currently written dBase III code to at least take
  182. a look at the program and try it out.  If it doesn't suit your needs, you
  183. have three choices:  1) write a letter, I'll see if I can help,  2) give the
  184. program to someone who can use it, or  3) erase it and never use it again.
  185.  
  186.